APP_SIGNATURE -- the signature of the (already open) application that will receive the event
EVENT_CLASS -- the event class to be sent (usually 'aevt', but it might be 'FNDR' or others)
EVENT_ID -- the event ID to be sent (e.g., 'odoc', 'pdoc', or 'quit')
The three parameters above must be separated by commas and be exactly four characters long.
The ARG_LIST is optional, and all tokens comprising it are separated by spaces, not commas. In order to allow embedded spaces, the scanner supports optional double-quotes (e.g., My File must be written as "My File" but MyFile can be written as either "MyFile" or MyFile). The ARG_LIST is a sequence of any number of ARGs, separated by spaces. An ARG is composed of three parts, a KEYWORD, a DESC_TYPE, and CONTENTS.
KEY_WORD -- a one-to-four-character AEKeyWord identifying the parameter ARG is to become
DESC_TYPE -- a one-to-four-character DescType describing the type of data to be contained in the parameter
CONTENTS -- a string representation of the data
Supported DESC_TYPEs and the format of their corresponding CONTENTS are:
long a long integer (32 bits) written out in ascii, or as a 4-character string enclosed in single quotes
shor a short integer (16 bits) written out in ascii
rect a rect (16 bits) written out as 4 shorts
TEXT an unterminated string, which may be enclosed in quotes if necessary
alis an alias for the file specified by full pathname, including disk name
fss a file system spec for the file specified by full pathname, including the disk name
poin a point specified as two short integers separated by a space
fwin a finder window specified by an alias for its folder
list a list, described below
$$$$ a string of generic hex data, described below
If DESC_TYPE is 'list' then the corresponding contents a list of list elements enclosed in brackets ("[" and "]"). The list elements themselves are each in two parts: a DESC_TYPE and a CONTENTS as described above.
If DESC_TYPE is '$$$$', then the corresponding contents have two parts: a DESC_TYPE which will be used as the real DescType of the arg and a series of hex characters which will be used as the contents themselves.
Note on Pathnames: Pathnames are specified in the following manner:
HARDDRIVE:FOLDER:FOLDER:FILE
so the pathname:
"hd80:system folder:junk"
refers to the file named "junk" in the folder "system folder" on the hard drive "hd80". Use quotation marks around a pathname that contains spaces (like the above example.)
There are several special pathnames that can make your life easier. They only work with System 7.0.
{boot} is the name of your the hard disk with your System Folder
{system} is the pathname of your System Folder
{desktop} is the pathname of the Desktop Folder for your boot drive. This contains all the files on the desktop that can be found on your boot drive, but not files from other drives or disks.
{trash} is the pathname of the Trash Folder for your boot drive. This contains all the files in your trash can that have come from your boot drive, but not trashed files from other drives or disks.
{printmonitor} is the pathname of the folder which contains files waiting to be printed by the printmonitor.
{startup} is the pathname of the Startup Folder. Applications in this folder are automatically launched when the Macintosh is started up.
{apple} is the pathname of the Apple Menu Items folder. Items in this folder are added to your apple menu.
{control} is the pathname of the Control Panels folder.
{extension} is the pathname of the Extensions folder.
{preferences} is the pathname of the Preferences folder.
{temp} is the pathname of the Temporary Folder, used for temporary storage of items.
so the pathname:
"{system}junk" refers to the file or folder named "junk" in the system folder of your boot drive.
"{boot}zippy:crank" refers to the file or folder named "crank" in the folder "zippy" on your boot drive.
Sends an apple event to the application whose signature is 'MACS' (the Finder). Makes it an 'sinf' event (“get info”) from the 'FNDR' class (“Finder events”). There are two parameters, the first of which is the “direct object” whose keyword is “----” and whose content is an alias for the folder “System 7.0” on “MyDisk”. The second parameter is a selection list whose keyword is “fsel” and whose contents are in the form of a 'list', whose two entries are aliases for the two documents “System” and “Finder”.
@VXTN(GEVT,DAD2,CANV,btol ---- shor 1)
Sends an apple event to the application whose signature is 'DAD2' (Canvas™ 3.0). Makes it a 'btol' event (basic tool) and selects tool #1.